home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / comm2 / clcht233.lha / CLChatClient233 / CLChatGUI.doc < prev    next >
Text File  |  1996-02-04  |  22KB  |  628 lines
  1.  
  2.  
  3. CLChatGUI
  4. *********
  5.  
  6. Welcome to the CLChatGUI, a full-featured GUI client to the
  7. CLChatSystem for AmiTCP.  The CLChatSystem, which is
  8. originally part of the Connectline BBS package, provides a
  9. multoi-server, IRC-like chat system with multiple channels, private
  10. messaging, operator privileges and more.
  11.  
  12. Within Connectline, also online user and Hydra file transfer
  13. protocol chat user may join the chat.  See the `CLChatServer
  14. Documentation' for more information about Connectline.
  15.  
  16. Connecting
  17. **********
  18.  
  19. Installation is fairly simply.  Simply put the archive contents
  20. somewhere on your harddisk.  Note that you need MUI 2.3 or better!
  21.  
  22. Before you can use CLChatGUI, you must connect to a chat server
  23. running CLChatD.
  24.  
  25. When started, CLChatGUI will prompt you for a server name and a port
  26. number to connect to.
  27.  
  28. If you are connected to a LAN, you should ask your network adminstrator
  29. for both server name and port number.
  30.  
  31. If you are connected to the Internet, see ARCnet for a good choice of
  32. servers to connect to.
  33.  
  34. You must also specify a Nickname and your Realname.  The nickname
  35. is a kind of username used within the chat system.  It may be up to 15
  36. byte long and must consist of letters, digits and the characters .
  37. and _. The realname is used for informational purposes only.
  38.  
  39. Note that the server may reject your connection attempt because the
  40. entered nickname is invalid or already in use by another chat user.
  41. Change your nick and retry the connection.
  42.  
  43. CLChatGUI keeps a history of the last servers you have connected to.
  44. You may choose from the history by clicking on the popup button right
  45. from the server name string gadget.  The history is saved within the
  46. configuration file.
  47.  
  48. Local chat
  49. **********
  50.  
  51. If you start the client on a machine running the CLChatServer, it
  52. will not connect using AmiTCP, but directly link to the chat server to
  53. reduce overhead.
  54.  
  55. If you want to avoid this behaviour, e.g. for testing purposes, start
  56. CLChatGUI with the TCPMode keyword or specify the
  57. TCPMode tooltype.
  58.  
  59. Using CLChatGUI
  60. ***************
  61.  
  62. After connecting to the chat server, the main window opens.  It
  63. consists of a channel selection gadget, a topic gadget, the main output
  64. window, your input string gadget and the user operation gadget group.
  65. It also features a menu bar with several options and shortcuts for
  66. server commands.
  67.  
  68. You send text to the chat server by simply entering it in the input
  69. gadget.  Commands are also send to the server by entering them in the
  70. input gadget.  You may want to use the /HELP command to learn about
  71. available server commands.  The input gadget is normally automatically
  72. activated; if it is not, simply press SPACE to activate it.  A
  73. history of the last 100 lines entered is kept; you may use
  74. Cursor/UP or Cursor/DOWN for accessing entries in the history.
  75.  
  76. Changing channels is done by entering a new channel name in the channel
  77. selection gadget.  Note that the server will automatically create a
  78. channel if it does not exist. Already existing channels may be selected
  79. with the popup listview right of the channel gadget. The popup button
  80. has a hidden keyboard shortcut h which opens the channel selection
  81. listview.
  82.  
  83. If you have channel operator status, you may change the current
  84. channel's topic by entering a new one in the topic gadget.  The
  85. contents of this gadget are automatically updated if someone else
  86. changes the topic.
  87.  
  88. User operations
  89. ***************
  90.  
  91. The user listview displays all users currently logged into the chat
  92. server and the name of the channel they are currently on. Users with
  93. channel operator privilege are marked with a @, users with chat
  94. operator privilege are marked with a ! before the name.
  95.  
  96. Double clicking on an entry in the user listview requests a /WHOIS
  97. user command from the server.  Pressing the Dialog button opens a
  98. special so-called dialog window.  A dialog window works much like the
  99. main windows, but every text entered within a dialog window is send
  100. directly as a private message to the user.  Also, any incoming private
  101. messages from this user are displayed in the dialog window and not the
  102. main window.  If the Auto checkbox is selected, a new dialog window
  103. is created for the originator of every incoming private message.
  104.  
  105. If you have channel or chat operator privilege, you may also use the
  106. OP, DEOP and KICK buttons to perform the requested operation on
  107. the selected user.
  108.  
  109. Via the PING button you can request a PING request from the selected
  110. user. If the user is running the GUI client, too, you will eventually
  111. receive a reply stating the round-tripe time from you to the remote
  112. user. This is usefull for TCP connections only.
  113.  
  114. If you have a TCP connection, you may also use the Send Files option
  115. to directly send files to the remote user; see FileTransfer for more
  116. information about this operation.
  117.  
  118. Setting the AWAY checkmark causes the AWAY message to be printed, and
  119. every private message to you will automatically respond with Nick is
  120. away (AWAY message).
  121.  
  122. Setup
  123. *****
  124.  
  125. In the setup window, you may modify several operation attributes.
  126.  
  127.     Autoconnect will cause an automatic connection attempt each time
  128. the CLChatGUI is started. Setting Auto Reconnect will cause
  129. automatic reconnect attempts if the connections drops.
  130.  
  131.     File Receive Path specifies the path you want incoming CLFT
  132. files to go (See FileTransfer.). Setting Auto Receive will start a
  133. CLFT receive session without prompting you for confirmation.
  134.  
  135.     Max. Number of Lines specifies how many lines of incoming text
  136. will be stored for the output listview.
  137.  
  138. You may log all or some of the chat server output to a log file; you may
  139. individually select Private, Server or normal Text messages to be
  140. stored in the log file.
  141.  
  142. The Event Handling checkboxes set the reaction of special events.
  143. You may set Deiconify to automatically deiconify the application on
  144. the given event, and DisplayBeep to just have the screen beep.
  145.  
  146. The message section allows you to specify standard texts send to the
  147. chat for given operations. The AWAY message is set when you select
  148. the AWAY checkbox in the main window, the BACK message is send
  149. when you clear the checkbox. The KICK message is a default kick
  150. reason if you kick users using the KICK button below the user
  151. listview.
  152.  
  153. You may create several different configuration files using the
  154. Save... and Load... items from the menu bar.  If you create
  155. icons for the configurations, you can start CLChatGUI by simply
  156. doubly clicking on the configuration icon.
  157.  
  158. FileTransfer
  159. ************
  160.  
  161. If you connect via AmiTCP, you may also use the CLFT protocol to
  162. directly send files to users linked to the chat network (comparable to
  163. the IRC `DCC protocol').  Simply select the user you want to send to,
  164. press the Send files button and a filerequester will open. You can
  165. also directly drop Workbench icons onto the user listview to have the
  166. correspondending files to be send to the currently selected user. If
  167. you have dialog windows open, you may also directly send files by
  168. dropping Workbench icons onto the dialog window.
  169.  
  170. When you have selected files, a CLFT request will be send to the
  171. remote user, and the CLFT sender window will open on your side,
  172. awaiting a connect from the receiving site.  The receiver will then
  173. eventually connect to you via TCP and grab the files offered to him.
  174.  
  175. If you receive incoming CLFT requests, a requester will open showing
  176. you the originator of the request, the number of files to be send and a
  177. list of the files to be transfered.  You may accept or reject the
  178. request, or you may change to destination directory.  Use the
  179. Setup window to change the default path in which incoming files are
  180. stored.  If you have Auto Receive set, no prompt will appear, but
  181. receiving will start immediately.
  182.  
  183. Incoming files are tagged with a filenote designating the originator
  184. nick and IP address for later identification.  If an equally named file
  185. already exists, the file name is postpended with ".2", ".3" etc.
  186.  
  187. You may abort file transfers at any time by clicking on the close
  188. gadget of the receive or send window.  All transfers currently waiting
  189. or in progress will automatically terminate if you quite CLChatGUI.
  190. Note that you cannot send files to users which are connected via TelNet
  191. or the Connectline ANSI client.
  192.  
  193. ARexx commands
  194. **************
  195.  
  196.     CLChatGUI features an ARexx port. The port name is
  197. CLCHATCLIENT.nr, with nr starting at 1 and increasing for
  198. every instance of the program started.
  199.  
  200. Besides the builtin MUI commands (see the `MUI User Guide'),
  201. CLChatGUI current features two commands:
  202.  
  203. SEND TEXT/F
  204.      Sends the given text string as it was entered in the input string
  205.      gadget.  Note that you may also send server commands this way.
  206.  
  207. RECONNECT
  208.      Cause the CLChatGUI to reconnect to the current server.
  209.  
  210. Server Commands
  211. ***************
  212.  
  213. Below is a list of normally available server commands. Don't forget to
  214. use the /HELP command to learn if your server supports a different
  215. command set.
  216.  
  217.    * /CHANNEL [name]
  218.      Join or create a channel
  219.  
  220.    * /INFO [name]
  221.      Show all or specific channel
  222.  
  223.    * /WHO
  224.      List users in channel
  225.  
  226.    * /USERS
  227.      List all users in chat. Note that the output from this command is
  228.      silently interpreted by the client and not displayed in the output
  229.      window.
  230.  
  231.    * /USERS S
  232.      List all users in chat together with the servers they are on
  233.  
  234.    * /WHOIS nick
  235.      Show info about user
  236.  
  237.    * /MSG nick msg
  238.      Send private msg to nick
  239.  
  240.    * /NICK [nick]
  241.      View or change your nick
  242.  
  243.    * /ME msg
  244.      Send action string
  245.  
  246.    * /VERSION
  247.      Show server version
  248.  
  249.    * /SERVERS
  250.      Show other servers connected to your local server
  251.  
  252.     Operator only commands:
  253.  
  254.    * /OP nick
  255.      Give operator state to nick
  256.  
  257.    * /DEOP nick
  258.      Remove operator state from nick
  259.  
  260.    * /TOPIC topic
  261.      Set topic of channel
  262.  
  263.    * /KICK nick reason
  264.      Kick nick out of channel
  265.  
  266. There are also special Chat operator commands which are not visible
  267. to the normal user or channel operator.  Use the /HELP command to
  268. obtain a list of chat operator commands directly from the server.
  269.  
  270. ARCnet
  271. ******
  272.  
  273.     ARCnet, the Amiga Relay Chat Network, is a Internet based
  274. network of CLChatServers available for public usage. As the time of
  275. writing, the following servers were connected to the network:
  276.  
  277.    * us1.clchat.vapor.com
  278.  
  279.    * us2.clchat.vapor.com
  280.  
  281.    * us3.clchat.vapor.com
  282.  
  283.    * us4.clchat.vapor.com
  284.  
  285.    * de.clchat.vapor.com
  286.  
  287.    * it.clchat.vapor.com
  288.  
  289. All servers run the CLChatServer on port 5555. All these servers are
  290. online 24h/day.
  291.  
  292. Check out http://monet.nfinity.com/arcnet/ for up-to-date
  293. information about the ArcNet server list.
  294.  
  295. Copyright
  296. *********
  297.  
  298. The CLChatSystem (CLChatServer, CLChatD , CLChatLink and
  299. CLChatGUI) is (C) 1996-1995 Oliver Wagner, All Rights Reserved.
  300.  
  301. The package may be distributed freely as long as all files are
  302. distributed as a whole archive and are not modified in any way.
  303.  
  304.     CLChatGUI is a MUI application.  MUI is (C) 1993-96 Stefan
  305. Stuntz.
  306.  
  307.     AmiTCP is (C) 1994-1995 NSDI Inc.
  308.  
  309. Please send bug-reports, suggestions and comments via E-Mail to
  310. owagner@lsd.wupper.de.
  311.  
  312. Updates are placed on AmiNet; they can also be downloaded via
  313. anonymous FTP directly from ftp.vapor.com.  You can also check out
  314. anonymous FTP at the servers listed in the ARCnet reference if they
  315. have a better link to your host.
  316.  
  317. History
  318. *******
  319.  
  320. Version 1.7
  321.         * Fixed a bug where small windows caused the the line formatter
  322.           to loop infinitely
  323.  
  324.         * added /SERVERS command to server command menu
  325.  
  326.         * default setting was saved to ENVARC only, so attempting to
  327.           load defaults without quitting caused the old defaults from
  328.           ENV to be read in
  329.  
  330. Version 2.0
  331.         * added CLFT file transfer capability
  332.  
  333.         * added /USERS S command to server command menu
  334.  
  335.         * miscellaneous internal fixes & cleanup work
  336.  
  337.         * now TCPMode can be used as a workbench icon tooltype, too
  338.  
  339. Version 2.1
  340.         * scroller now does not jump to the bottom when new entries are
  341.           appended if it not already was there.
  342.  
  343.         * smoothed out removing of lines in the main listview.
  344.  
  345.         * added PING option to test round trip time to another user.
  346.           Note that his works with the GUI client only!
  347.  
  348.         * fixed workbench startup bug: always attempted to load the
  349.           executable itself as a settings file thus ignoring any
  350.           default settings in ENV:.
  351.  
  352.         * added new option Auto Reconnect to automatically attempt
  353.           to reconnect if the server connections breaks down.
  354.  
  355.         * nick changes are now tracked and correspondending dialog
  356.           windows are updated with the new nickname
  357.  
  358.         * changed ping frequency back to 15s to reduce IP load
  359.  
  360.         * miscellaneous internal fixes & cleanup work
  361.  
  362. Version 2.2 (internal)
  363. Version 2.3
  364.         * smoothed out scroller handling a bit; will now jump to the
  365.           bottom on window resizes, and will jump as long as no more
  366.           than two lines are scrolled up
  367.  
  368.         * file transfer tasks now run with priority 1 for maximum
  369.           performance
  370.  
  371.         * added better icon created by `NEUMANN'
  372.  
  373.         * minor speedup in listview display hook
  374.  
  375.         * added missing cycle chain for option window
  376.  
  377. Version 2.4
  378.         * now activating any output window automatically actives the
  379.           correspondending input string gadget
  380.  
  381. Version 2.5
  382.         * fixed bug with lines > 255 chars to be corrupted upon listview
  383.           insertion
  384.  
  385.         * fixed several types in texts
  386.  
  387.         * now file transfer can be initiated by dropping icons onto a
  388.           dialog window
  389.  
  390.         * will no longer change topic string gadget contents while user
  391.           is editing it
  392.  
  393. Version 2.6 (internal)
  394. Version 2.7 (internal)
  395. Version 2.8
  396.         * changed prefix entries to be more clearly
  397.  
  398.         * fixed several hidden internal race conditions regarding CLFT
  399.           cleanup which could case enf-hits or visits to india
  400.  
  401.         * option window is now a register group
  402.  
  403.         * added CLFT auto receive option
  404.  
  405.         * added logging capability
  406.  
  407.         * added PING and SEND FILE buttons to the user dialog windows
  408.  
  409.         * it is now possible to enter commands in the user dialog
  410.           windows
  411.  
  412.         * added server history feature
  413.  
  414.         * added AWAY feature
  415.  
  416.         * added AWAY, BACK and KICK message configurability
  417.  
  418.         * fixed topic gadget to always update when the window is
  419.           deactivated even if it is the active object
  420.  
  421. Version 2.9
  422.         * changed "««" within dialog window to "IN"
  423.  
  424.         * fixed various problems with dialog window listview handling
  425.           (no proper flushing, no proper jump-to-bottom)
  426.  
  427.         * now dialog windows will automatically be activated when
  428.           "DIALOG" is select for an user for whom a window already
  429.           exists
  430.  
  431.         * removed AmiTCP dependancy due to time() from net.lib. Now has
  432.           it's own, even faster time() implementation using
  433.           timer.device's GetSysTime()
  434.  
  435. Version 2.11
  436.         * fixed word-wrap bug
  437.  
  438.         * added "CLFT Auto Close Window" option
  439.  
  440.         * several internal cleanups
  441.  
  442. Version 2.12 (not released)
  443.         * fixed CLFT Receive abort bug
  444.  
  445.         * added internal text commands "/PING nick", "/QUERY nick",
  446.           "/AWAY <text>" and "/SEND nick" as shortcuts for the
  447.           equivalent GUI operations
  448.  
  449. Version 2.13
  450.         * fixed CLFT Receive accessing the wrong SocketBase
  451.  
  452. Version 2.14 (not released)
  453.         * added regular quit operation including a preference
  454.           definition for the default quit reason string if clchatgui is
  455.           closed by close gadget, rexx command or CX exchange.  /QUIT
  456.           now causes CLChatGUI to terminate itself.
  457.  
  458.         * added version query. Syntax is "/VERSION user", version
  459.           without any parameters get's send to the server as usal,
  460.           querying the server version.
  461.  
  462.         * added proper error returns for wrong parameters with the
  463.           internal text commands.
  464.  
  465.         * added Auto-Away capability, setting the user automatically
  466.           /AWAY after X minutes of inactivity.
  467.  
  468.         * cleaned up User listview refresh. Now refreshes less
  469.           frequently and keeps the previous selection state upon list
  470.           changes. Now sorted alphabetically and by user state.
  471.  
  472.         * the clft send file requester now no longer rejects icon files.
  473.  
  474. Version 2.15
  475.         * now quits with message "Changing Server" when changing server
  476.           using the "Change Server" menu item.
  477.  
  478.         * updated the built-in default server list.
  479.  
  480. Version 2.16
  481.         * fixed auto-away timeout to not be reset by input done in
  482.           dialog windows.
  483.  
  484. Version 2.17
  485.         * Auto-Away has now a checkmark for turning it on/off.
  486.  
  487.         * added auto away warning message.
  488.  
  489.         * Added Auto-Unaway upon message entering.
  490.  
  491.         * fixed options window cycle chain.
  492.  
  493.         * added a reset handler to gracefully terminate the server link
  494.           upon CAA-reset.
  495.  
  496.         * added Autojoin channel feature.
  497.  
  498.         * fixed a bug in CLFT which caused file names which where
  499.           ERROR_OBJECT_IN_USE to be not bumped accordingly.
  500.  
  501.         * now the CLFT process check MUI events more regularly, and
  502.           outputs current cps in the gauge display.
  503.  
  504.         * no more AWAY respone for VERSION query replies.
  505.  
  506. Version 2.18 (Release Version of 2.17)
  507. Version 2.19
  508.         * added support for private channels, including SetPriv/ClrPriv
  509.           buttons for channel and Allow/Disallow buttons for the user
  510.           listview.
  511.  
  512.         * added VERSION request button to the user listview.
  513.  
  514.         * the user listview buttons are now using the tiny MUI font.
  515.  
  516.         * now dialog windows have a input string history, too.
  517.  
  518.         * fixed automatic string gadget activation when clicking into
  519.           dialog windows.
  520.  
  521. Version 2.20
  522.         * fixed CLFT windows to properly open on the screen the main
  523.           window is on.
  524.  
  525.         * added DCC support for IRC compatibility. Note that /DCC SEND
  526.           doesn't work correctly if no filename is specified on the
  527.           command line.  Requires DCC.xxx.AS225.
  528.  
  529.         * "Send files" from dialog windows didn't worked correctly.
  530.  
  531.         * various internal fixes.
  532.  
  533. Version 2.21 (internal only)
  534. Version 2.22
  535.         * added support for ircII formating codes: CTRL-B, CTRL-_ and
  536.           CTRL-V. You need to turn of Input Filtering in IControl Prefs
  537.           to use these.
  538.  
  539.         * now, the CLFT incoming requester will also appear on the right
  540.           screen.
  541.  
  542.         * CLFT send is now compatible with file requester
  543.           implementations which don't correctly return fr_NumArgs == 1
  544.           when only a single file is selected.
  545.  
  546. Version 2.23
  547.         * some internal cleanup (i.e. the main module is no longer
  548.           compiled with NOCONSTLIBBASE to save speed & size)
  549.  
  550.         * now autounaway is only triggered by public messages.  This
  551.           also fixes the bug that /AWAY doesn't work correctly when
  552.           autounaway is active.
  553.  
  554. Version 2.24
  555.         * now bums the nickname to "nick1", "nick2" etc. if nickname is
  556.           in use during login.
  557.  
  558.         * small internal cleanups.
  559.  
  560. Version 2.25 (not released)
  561.         * stupid bug in AWAY loop protection fixed.
  562.  
  563. Version 2.26
  564.         * now /SEND can accept file names as well (e.g. "/SEND nick
  565.           ram:arc.lha").
  566.  
  567.         * no longer crashes upon receiving ^C in TCPMode
  568.  
  569. Version 2.27
  570.         * removed now unnecessary /USERS request upon receiving
  571.           [LINK] or [UNLINK] messages.
  572.  
  573.         * no longer crashes when trying to send something in the connect
  574.           window via the server command menu.
  575.  
  576.         * now reacts on ^C in local mode as well.
  577.  
  578.         * the "Auto-AWAY in 1 Minute" now also occurs in local mode.
  579.  
  580. Version 2.28 (not released)
  581.         * can now play a sound instead of simply beeping. Uses
  582.           sound.datatype, so can load everything you've got a data type
  583.           for.
  584.  
  585. Version 2.29
  586.         * fixed e-mail & http addresses in info requester.
  587.  
  588. Version 2.30
  589.         * fixed the default server list.
  590.  
  591.         * added a default sound setting for OS 3.x machines.
  592.  
  593.         * added a sample sound file courtesy of Sandro Catallo.
  594.  
  595.         * recompiled with SAS/C 6.56.
  596.  
  597.         * fixed some MUI3 stuff.
  598.  
  599. Version 2.31 (internal only)
  600. Version 2.32
  601.         * added some MUI3 support.
  602.  
  603.         * fixed potential crash on dialog window close.
  604.  
  605. Version 2.33
  606.         * did some GUI cleanup.
  607.  
  608.         * hopefully finally fixed the crash problem with closign dialog
  609.           windows.
  610.  
  611. Index
  612. *****
  613.  
  614.  
  615.  
  616.  ARCnet                                 ARCnet
  617.  ARexx commands                         ARexx commands
  618.  Connecting                             Connecting
  619.  Copyright                              Copyright
  620.  FileTransfer                           FileTransfer
  621.  History                                History
  622.  Local chat                             Connecting
  623.  Server Commands                        Server Commands
  624.  Setup                                  Setup
  625.  User operations                        Using CLChatGUI
  626.  Using CLChatGUI                        Using CLChatGUI
  627.  
  628.